Konfiguration
WebRTC Connect bündelt die gesamte Einrichtung auf dem Tab der Modul-Oberfläche. Sie sehen dort auf einen Blick, ob die STARFACE die nötigen Voraussetzungen erfüllt, wählen die Benutzer aus und stellen mit einem Klick auf das Gateway bereit.
Solange das Gateway aktiv ist, sind die Einstellungen schreibgeschützt. Klicken Sie zuerst auf , um Werte wieder bearbeiten zu können.
Zertifikat
Browser bauen die Verbindung nur über ein vertrauenswürdiges TLS-Zertifikat auf. WebRTC Connect verwendet dafür das Zertifikat, das in der STARFACE bereits für den Webserver hinterlegt ist, und stellt es dem WSS-Listener bereit.
Sorgen Sie dafür, dass in der STARFACE ein gültiges, öffentlich vertrauenswürdiges Zertifikat liegt, dessen CN oder SAN dem öffentlichen FQDN der Anlage entspricht.
Für wss://-Verbindungen akzeptieren Browser keine selbstsignierten Zertifikate. Ohne gültiges Zertifikat meldet sich kein Browser-Client an.
Eine Anlage nutzt bereits ein Wildcard-Zertifikat *.meinefirma.de für den STARFACE-Webserver. Sie müssen nichts
Zusätzliches kaufen – WebRTC Connect verwendet dieses Zertifikat direkt für die Browser-Telefonie.
Benutzerauswahl
Im Bereich Benutzer legen Sie fest, wer per Browser telefonieren soll. Klicken Sie auf das Stift-Symbol , um den Auswahldialog zu öffnen.
Für jeden ausgewählten Benutzer legt WebRTC Connect automatisch ein eigenes SIP-Konto an, vergibt ein Passwort und meldet das Konto an der STARFACE an. Entfernen Sie einen Benutzer wieder, wird das zugehörige Konto automatisch abgebaut.
Am unteren Rand zeigt eine Lizenzanzeige, wie viele der lizenzierten Plätze belegt sind. Ist das Limit erreicht, lässt sich kein weiterer Benutzer hinzufügen.
Der Empfang soll zusätzlich am Browser erreichbar sein. Sie haken den Benutzer „Empfang" an und speichern – das SIP-Konto entsteht sofort, ganz ohne manuelles Anlegen in der STARFACE.
SIP-Konten
Die SIP-Konten-Tabelle zeigt pro ausgewähltem Benutzer das zugehörige Browser-Konto mit seinem aktuellen Zustand:
| Spalte | Bedeutung |
|---|---|
| Benutzer / Konto | Der STARFACE-Benutzer und das automatisch erzeugte SIP-Konto. |
| Passwort | Das vom Modul vergebene Konto-Passwort (zur Einrichtung des Browser-Clients einblendbar). |
| Registrierung | Zeigt an, ob aktuell ein Browser-Client für dieses Konto angemeldet ist. |
| Mobile-Push | Schaltet die Push-Weckung für ein geschlossenes mobiles Softphone ein (zusammen mit AíPowerDesk). |
Ist Mobile-Push für ein Konto aktiv, hält das Gateway die Erreichbarkeit auch dann aufrecht, wenn das mobile Softphone geschlossen ist. Bei einem eingehenden Anruf wird der Nutzer per Web-Push geweckt; nach dem Öffnen der App übernimmt er den noch klingelnden Ruf. Der Versand der Push-Nachricht erfolgt über AíPowerDesk.
Connect / Disconnect
Mit startet WebRTC Connect das Gateway und die zugehörigen Dienste (WebRTC↔SIP-Gateway, Media-Dienst, Firewall-Regeln). Ab diesem Moment können sich die Browser-Clients anmelden und telefonieren. beendet das Gateway wieder.
Ein Watchdog überwacht die Dienste laufend und stellt sie bei einem Ausfall selbstständig wieder her.
Live-SIP-Ansicht (Experten-Modus)
Aktivieren Sie auf dem Tab den , um die Live-SIP-Ansicht auf dem Einstellungen-Tab einzublenden. Sie zeigt zwei Listen in Echtzeit:
- Registrierungen – jede An- und Abmeldung eines Browser-Clients (erfolgreiche Registrierung grün, fehlgeschlagene Anmeldung rot).
- Anrufe – die laufenden Anruf-Flows mit ihrem Zustand (Aufbau, aktiv, beendet).
So sehen Sie ohne Shell-Zugriff, dass das Gateway Meldungen verarbeitet.
Bei der Inbetriebnahme prüfen Sie, ob ein Testgerät korrekt anmeldet. Sie öffnen die Live-Ansicht, melden den Browser an – und sehen sofort einen grünen Eintrag unter Registrierungen. Die Einrichtung ist damit bestätigt.
Die Live-SIP-Ansicht dient ausschließlich der Fehleranalyse im laufenden Betrieb. Registrierungen und Anrufe werden nicht dauerhaft gespeichert.
Häufige Stolpersteine
-
Kein Browser-Client meldet sich an
Prüfen Sie, ob ein gültiges, öffentlich vertrauenswürdiges Zertifikat auf den FQDN ausgestellt ist und ob WSS 8443/TCP von außen erreichbar ist. -
Anmeldung klappt, aber kein Ton
Der Medienpfad ist nicht durchgängig. Prüfen Sie, ob der Media-Bereich 30000–40000/UDP von außen erreichbar ist (Port-Weiterleitung am Router) und die STARFACE unter ihrer öffentlichen IP erreichbar ist. -
Externe Clients funktionieren nicht, interne schon
Typisches NAT-Symptom. Sorgen Sie dafür, dass die öffentliche IP-Adresse der Anlage korrekt erkannt ist und die Media-Ports nach außen weitergeleitet werden.